home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / docs / help / LibrariesGuide.readme < prev   
Text File  |  1994-12-18  |  5KB  |  126 lines
  1. Short:    AmigaGuide to AmigaDOS Shared Libraries
  2. Author:   dast@sth.frontec.se
  3. Uploader: istrice@paola.dei.unipd.it
  4. Type:     docs/help
  5.  
  6.  
  7.    The  original file  I've found  in  `aminet/docs/help/' was a standard
  8. plain file:  short, printable ... readable ..., but  not the  best for  a
  9. quick  consultation. That is why I've translated it to an AmigaGuide for-
  10. mat: a bit longer, more readable, easy to use, ...   8)
  11. The translation  was made with the  great aid of `AGW' by David L. McPaul
  12. (you may find in `aminet/text/hyper/AGWriter???.lha').
  13.  
  14. P.S.: the  guide has several nodes linked to AutoDocs (in the  AmigaGuide
  15.       format). Then you  are supposed to have propely set AmigaGuide path
  16.       env (try `aminet/text/hyper/GuidePrefs.lha'  if you are not so con-
  17.       fident with  this  issue), and  to  have  the AmigaGuide version of
  18.       AutoDocs.
  19.       You  are also  supposed to  have the assignment `TEXT-INCLUDE:' set
  20.       too. Of course you also need include-files.
  21.  
  22.    I (the AmigaGuide-er) may be reached at the following addresses:
  23.  
  24.                 E-Mail: istrice@paola.dei.unipd.it
  25.                         istrice2@maya.dei.unipd.it
  26.  
  27. Ciao
  28.      Alessandro Ponzio
  29.  
  30.                                                             ////
  31.                                                            ////
  32.                                                           ////
  33.                                                          ////
  34.                                                    \\\\ ////
  35.                                                     \\\X///
  36.                                                      \XXX/ Amiga®
  37.  
  38. *************************************************************************
  39.  
  40. This is an ASCII formatted article describing most of the things AmigaDOS
  41. shared libraries are all about. This is the table of contents:
  42.  
  43. 1                           Shared Library Overview
  44.   1.1 Shared Library
  45.   1.2 Link Library
  46.   1.3 ROM Based/Disk Based Libraries
  47.   1.4 Memory Usage
  48.   1.5 Other Operating Systems
  49.   1.6 Advantages
  50.  
  51. 2                       Calling Shared Library Functions
  52.   2.1 Address Library Functions
  53.   2.2 Library Base
  54.   2.3 Index
  55.   2.4 Parameters
  56.   2.5 Access Libraries
  57.     2.5.1 OpenLibrary()
  58.     2.5.2 CloseLibrary()
  59.     2.5.3 RemLibrary()
  60.   2.6 Return Code
  61.   2.7 Glue Code
  62.   2.8 C and Register Parameters
  63.     2.8.1 SAS/Dice pragmas
  64.     2.8.2 Aztec/Maxon pragmas
  65.     2.8.3 How to create pragma files
  66.   2.9 Near Data Effects
  67.   2.10 Registers
  68.  
  69. 3                  Parts of an AmigaDOS Shared Library Image
  70.   3.1 Prevent Execution
  71.   3.2 ROMTag Structure
  72.   3.3 Init Table
  73.   3.4 Function Pointer Table
  74.   3.5 Data Table
  75.   3.6 Init Routine
  76.   3.7 Functions
  77.  
  78. 4                           Libraries in the System
  79.   4.1 Library Opening Details
  80.   4.2 Library List
  81.   4.3 Patching Libraries
  82.  
  83. 5                                 Programming
  84.   5.1 Functions
  85.     5.1.1 Open()
  86.     5.1.2 Close()
  87.     5.1.3 Expunge()
  88.     5.1.4 Extfunc()
  89.   5.2 Function Descriptor File
  90.   5.3 Glue Code
  91.   5.4 Compiling
  92.   5.5 Linking
  93.   5.6 Debugging
  94.   5.7 Hints
  95.  
  96. 6                        Support library calls from ARexx
  97.   6.1 How ARexx access the library
  98.   6.2 ARexx calls a library function
  99.   6.3 ARexx function
  100.  
  101.                                      Appendix
  102. A. Version numbers and shared libraries
  103. B. Further reading
  104. C. Library source examples
  105.  
  106.  
  107. ============================= Archive contents =============================
  108.  
  109. Original  Packed Ratio    Date     Time    Name
  110. -------- ------- ----- --------- --------  -------------
  111.      628     266 57.6% 21-Sep-94 16:07:44  Libraries.info
  112.      492     248 49.5% 21-Sep-94 16:06:10  Libraries/Icons/AmigaDOS/libraries.info
  113.     1892    1007 46.7% 21-Sep-94 16:06:10  Libraries/Icons/MagicWB/libraries.info
  114.     1464     488 66.6% 21-Sep-94 16:06:08  Libraries/Install.info
  115.      582     338 41.9% 21-Sep-94 16:06:08  Libraries/Install/English.info
  116.     6080    1681 72.3% 21-Sep-94 16:06:08  Libraries/Install/Install
  117.      587     341 41.9% 21-Sep-94 16:06:08  Libraries/Install/Italiano.info
  118.      601     358 40.4% 21-Sep-94 16:06:08  Libraries/Install/ReadMe
  119.      427     213 50.1% 21-Sep-94 16:06:08  Libraries/Install/ReadMe.info
  120.    68136   22970 66.2% 21-Sep-94 16:41:46  Libraries/libraries
  121.      492     250 49.1% 21-Sep-94 16:06:08  Libraries/libraries.info
  122.     3327    1363 59.0% 21-Sep-94 16:06:08  Libraries/ReadMe
  123.      427     214 49.8% 21-Sep-94 16:06:08  Libraries/ReadMe.info
  124. -------- ------- ----- --------- --------
  125.    85135   29737 65.0% 03-Oct-94 14:06:58   13 files
  126.